Skip to content

chore(docs): settle yarn's unmet peer requirements - #25779

Merged
alejoamiras merged 1 commit into
nextfrom
worktree-docs-yarn-peers
Nov 8, 2026
Merged

alejoamiras merged 1 commit into
nextfrom
worktree-docs-yarn-peers

Conversation

@alejoamiras

Copy link
Copy Markdown
Contributor

The docs yarn install warned about 39 unmet peer dependencies. None of them was a package the docs use without declaring it, so this only tells Yarn which peers aren't needed here, and passes two real ones through. Installs are now warning-free; the lockfile and the installed packages don't change.

`yarn install` in docs/ printed YN0086 for 39 unmet peer requirements.
None is a dependency docs uses without declaring: react, react-dom,
@mdx-js/react and @docusaurus/plugin-content-docs are already direct
dependencies. packageExtensions in .yarnrc.yml now:

- mark optional the peers that no package loads where they go
  unprovided: Algolia autocomplete's client peers (.d.ts only),
  react on @docusaurus/types (types only) and on the helmet copies
  it holds for types, core's @mdx-js/react (core resolves it from the
  site directory), file-loader's webpack and ts-node's @types/node;
- pass a real peer through from the parent where an intermediate
  dropped it: plugin-content-docs via theme-mermaid, and react and
  react-dom via plugin-css-cascade-layers.

Each entry is pinned to the version it was checked against, so an
upgrade brings the warning back. No package.json or yarn.lock change:
a clean install resolves the same tree as before.
@alejoamiras
alejoamiras requested a review from a team as a code owner November 6, 2026 18:20
@alejoamiras
alejoamiras merged commit 03e1981 into next Nov 8, 2026
16 checks passed
@alejoamiras
alejoamiras deleted the worktree-docs-yarn-peers branch November 8, 2026 12:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants